home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 4.iso / documents / irix5.2plusNewProds / instGuideChanges < prev    next >
Text File  |  1994-08-01  |  17KB  |  446 lines
  1.  
  2. This document contains the major changes between the 4.X and the 
  3. 5.2 versions of the Installation Guide.
  4.  
  5.  
  6. Chapter 3 changes:
  7. ------------------
  8.  
  9.  
  10. 3.1 Enabling BOOTP Forwarding on Routers
  11.  
  12. All routers (workstations or other devices with multiple network 
  13. connections) between your workstation and a remote workstation that 
  14. has the software distribution you plan to use must be modified to 
  15. enable bootp forwarding. inst uses the Internet Bootstrap Protocol 
  16. (BOOTP) to obtain IP addresses, but the default configuration of 
  17. bootp(1M) in /usr/etc/inetd.conf prevents this.
  18.  
  19. Step 1 below describes how to identify routers. Step 2 describes how 
  20. to check to see if /usr/etc/inetd.conf has already been modified to 
  21. enable bootp forwarding on Silicon Graphics workstations. Steps 3 
  22. and 4 describe how to make the modifications on Silicon Graphics 
  23. workstations. The procedure for making modifications to other types  
  24. of routers may be different. You may want to ask a System Administrator  
  25. or the owners of the routers to make the modifications for you.
  26.  
  27.  
  28.     1) Find out the names of the routers with the command:
  29.  
  30.        % /usr/etc/ping -R -c 1 <server>
  31.  
  32.        The ping output has a section that begins with RR:. It shows the 
  33.        route of a packet from your workstation to <server> and back to  
  34.        your workstation. Each of the workstations listed, other than 
  35.        <server> and your workstation, is a router.
  36.  
  37.  
  38.     2) Check the bootp line in /usr/etc/inetd.conf on each router. The 
  39.        bootp line in /usr/etc/inetd.conf looks like this by default:
  40.  
  41.        bootp   dgram   udp     wait    root    /usr/etc/bootp       bootp
  42.  
  43.        After the line has been changed (-f added), it should look like this:
  44.  
  45.        bootp   dgram   udp     wait    root    /usr/etc/bootp      bootp -f
  46.  
  47.  
  48.     3) If the file has not been changed, edit /usr/etc/inetd.conf '-f' as
  49.        shown above. To simplify changing the file back to its original 
  50.        state, you may want to copy the original line, comment out one copy 
  51.        and change the other. 
  52.  
  53.     4) Give this command as superuser to make the change take effect:
  54.  
  55.        # /etc/killall -v -HUP inetd
  56.  
  57.  
  58.     When the remote system is no longer needed for software installation, 
  59.     you can return the /usr/etc/inetd.conf file to its original state if 
  60.     desired and give the killall(1M) command again to make that change 
  61.     take effect.
  62.  
  63.  
  64.  
  65. 3.2 Enabling TFTP Access on Remote Workstations
  66.  
  67. The remote workstation that has the software distribution directory, tape 
  68. drive, or CD-ROM drive you plan to use must be modified to allow tftp 
  69. access. inst uses Trivial File Transfer Protocol (TFTP) in its transfer of 
  70. files from remote workstations, but the default configuration of tftpd(1M)  
  71. in /usr/etc/inetd.conf doesn't allow this transfer.
  72.  
  73. Step 1 below describes how to check to see if /usr/etc/inetd.conf has already 
  74. been modified to allow tftp access. Steps 2 through 5 describe how to make 
  75. the modifications. You may want to ask a System Administrator or the 
  76. owner of the remote workstation to make the modifications for you.
  77.  
  78.     1) Check the tftp line in /usr/etc/inetd.conf on the remote 
  79.        workstation. The tftp line in /usr/etc/inetd.conf looks like 
  80.        this by default:
  81.  
  82.        tftp dgram udp wait guest /usr/etc/tftpd tftpd -s /usr/local/boot
  83.  
  84.        After the line has been changed (-s /usr/local/boot removed), it
  85.         should look like this:
  86.  
  87.        tftp dgram udp wait guest /usr/etc/tftpd tftpd 
  88.  
  89.        This change allows tftpd access to all publicly readable 
  90.        directories. The line might also have been modified as described 
  91.        in Step 3 and 4 below.
  92.  
  93.     2) If the file has not been changed, edit /usr/etc/inetd.conf to 
  94.        remove "-s /usr/local/boot" as shown above. To simplify changing 
  95.        the file back to its original, secure state, you may want to copy 
  96.        the original line, comment out one copy and change the other. 
  97.  
  98.     3) If you want, you can limit remote access to just the distribution 
  99.        directory, CD-ROM distribution, or tape drive. Edit the tftp line 
  100.        in /usr/etc/inetd.conf again and add a directory at the end of 
  101.        the line as shown below. The first line below is for a distribution 
  102.        directory, the second line is for a CD-ROM distribution, and the 
  103.        third is for tape.
  104.  
  105.    tftp dgram udp wait guest /usr/etc/tftpd tftpd -s /usr/local/boot <distdir>
  106.  
  107.    tftp dgram udp wait guest /usr/etc/tftpd tftpd -s /usr/local/boot <CDdir>/dist 
  108.    tftp dgram udp wait guest /usr/etc/tftpd tftpd -s /usr/local/boot /dev 
  109.  
  110.  
  111.     5) Give this command as superuser to make any changes to 
  112.        /usr/etc/inetd.conf take effect:
  113.  
  114.        # /etc/killall -v -HUP inetd
  115.  
  116.     When the remote system is no longer needed for software installation, 
  117.     you can return the /usr/etc/inetd.conf file to its original state if 
  118.     desired and give the killall(1M) command again to make that change 
  119.     take effect.
  120.  
  121.  
  122.  
  123. 3.3 Configuring an Installation User ID
  124.  
  125. When you are doing an installation from a remote distribution source,inst 
  126. uses the user ID guest (with no password) on the remote workstation by 
  127. default. If a guest user ID without a password is available on the remote 
  128. workstation, then that user ID can be used without modification. 
  129.  
  130. If no guest account exists on the remote workstation or the guest account 
  131. has a password (typically this would be done to limit access to the remote 
  132. workstation by rsh), you must provide an alternate means for inst to access 
  133. the remote workstation. There are three alternatives:
  134.  
  135.     o Remove the password from guest while installations are taking place.
  136.  
  137.     o Use a different user ID on the remote workstation that does not 
  138.       have a password. This user ID is specified with the inst ¡f flag
  139.  
  140.     o Use a user ID with a password on the remote workstation and special 
  141.       entries in its .rhosts file on the remote workstation. An entry 
  142.       needs to be made for each workstation that uses the remote 
  143.       workstation for installation. Each entry contains the name of 
  144.       the local workstation and the name of the user ID to be used on 
  145.       the remote workstation. For example, the file 
  146.       /usr/people/instuser/.rhosts on the workstation "bigserver" might
  147.       contain the lines:
  148.  
  149.       joesbox.engr.xxx.com            instuser
  150.       lab1.engr.xxx.com               instuser
  151.  
  152.       When installing new software on "joesbox" or "lab1", you would 
  153.       give one of these two commands, depending on the circumstances:
  154.  
  155.       # /usr/sbin/inst -f instuser@bigserver:<path>
  156.  
  157.       Inst> from instuser@bigserver:<path>
  158.  
  159.       where <path> is the device or directory that has the software 
  160.        distribution. Sections 7.5 and 10.2 describe inst ¡f and from, 
  161.       respectively. /usr/people/instuser/.rhosts must have the correct 
  162.       owner and permissions for this to work. See the hosts.equiv(4) 
  163.       manual page for details.
  164.  
  165. No matter what user ID you choose, it must have read permission for the 
  166. software distribution source (the tape drive, the directory where the 
  167. CD-ROM drive is mounted, or the distribution directory).
  168.  
  169.  
  170.  
  171.  
  172. Chapter 7 changes / Prom Chart:
  173. ------------------
  174.  
  175. Table 7-1 Miniroot Installation Procedures:
  176.                                                         Remote
  177.                         Local   Local   Remote  Remote  Distribution
  178. <cpu>                   Tape    CD-ROM  Tape    CD-ROM  Directory
  179. --------------------------------------------------------------------
  180. IP4                     A       N/A     F       H       J
  181. IP5, IP6, IP7, IP9      A       C       F       H       J
  182. IP12, IP17              A       D       F       H       J
  183. IP19, IP20, IP22        B       E       G       I       K
  184. --------------------------------------------------------------------
  185.  
  186.  
  187.  
  188. Table 7-2 Command Monitor Commands to Load the Miniroot:
  189.  
  190. Procedure                       Commands
  191. --------------------------------------------------------------------
  192. A                       >> setenv tapedevice <device>(<cntlr>,<unit>)
  193.                         >> boot -f $tapedevice(sash.<cpu>) --m 
  194.  
  195. B                       >> setenv tapedevice <device>(<cntlr>,<unit>)
  196.                         >> boot -f $tapedevice(sashARCS) --m 
  197.  
  198. C                       >> dksc(<cntlr>,<unit>,8)sash.<cpu> -m 
  199.  
  200. D                       >> dksc(<cntlr>,<unit>,8)sash<cpu> -m 
  201.  
  202. E                       >> dksc(<cntlr>,<unit>,8)sashARCS -m 
  203.  
  204. F                       >> setenv tapedevice bootp()<server>:<tapedevice>
  205.                         >> boot -f $tapedevice(sash.<cpu>) --m
  206.  
  207. G                       >> setenv tapedevice bootp()<server>:<tapedevice>
  208.                         >> boot -f $tapedevice(sashARCS) --m
  209.  
  210. H                       >> setenv tapedevice bootp()<server>:<CDdir>/dist/sa
  211.                         >> boot -f $tapedevice(sash.<cpu>) --m
  212.  
  213. I                       >> setenv tapedevice bootp()<server>:<CDdir>/dist/sa
  214.                         >> boot -f $tapedevice(sashARCS) --m
  215.  
  216. J                       >> setenv tapedevice bootp()<server>:<distdir>/sa
  217.                         >> boot -f $tapedevice(sash.<cpu>) --m
  218.  
  219. K                       >> setenv tapedevice bootp()<server>:<distdir>/sa
  220.                         >> boot -f $tapedevice(sashARCS) --m
  221. --------------------------------------------------------------------
  222.  
  223.  
  224.  
  225.  
  226.  
  227. Chapter 8 changes:
  228. ------------------
  229.  
  230. 8.2.2 Checking Network Connections
  231.  
  232. The steps below explain several tests and checks that you can perform to 
  233. verify your workstations connection to a remote workstation.
  234.  
  235.     1) Test the TCP/IP connection from IRIX.
  236.  
  237.       If IRIX is running on your workstation, do a simple check of the 
  238.       network connection with this command:
  239.  
  240.       % /usr/bsd/rsh <server> -l <user> date
  241.  
  242.       where <server> is the name of the remote workstation and <user> 
  243.       is the user ID you are using for installation. Normally, <user> 
  244.       is "guest". If the date isn't returned, you've specified the wrong 
  245.        <server>, there is a network problem, or <user> isn't a valid user 
  246.       ID. 
  247.  
  248.     2) Test the TCP/IP connection from inst.
  249.  
  250.       Connections to remote workstations are done over terminal control 
  251.       program/internet protocol (TCP/IP) in a manner similar to rsh(1C).  
  252.       A simple test of this connection can be done while you are doing 
  253.       an IRIX Installation by escaping to a shell from any inst prompt 
  254.       and using ping(1M):
  255.  
  256.       Inst> sh
  257.  
  258.       # /usr/etc/ping -q -f -s 2048 -c 100 <server>
  259.       PING <server> (<IPaddress>): 2048 data bytes
  260.  
  261.       ----<server> PING Statistics----
  262.  
  263.       100 packets transmitted, 100 packets received, 0% packet loss
  264.       round-trip (ms)  min/avg/max = 0/2/7
  265.       # exit
  266.       Inst>
  267.  
  268.       where <server> is the name of the remote workstation. If you see 
  269.       packet loss, you could have a problem with your network connection.
  270.  
  271.       This network connection test is not possible if you are using 
  272.       Miniroot Installation; if you are, test the connection before 
  273.       beginning the installation if possible. Use the same ping 
  274.       command as in the example above while in an IRIX shell.
  275.  
  276.     3) Check the setting of the netaddr NVRAM variable.
  277.  
  278.       In some situations, you might have network problems if the IP 
  279.       address (<localIPaddress>) of your workstation in its non-volatile 
  280.       random access memory (NVRAM) doesn't match its IP address in 
  281.       /etc/hosts. A mismatch can occur when you move a workstation, but 
  282.       not cause a problem until you attempt to load the miniroot for a 
  283.       software installation. You can check the IP address in the NVRAM 
  284.       on your workstation while you are using IRIX, or when you have 
  285.       escaped to the shell while using inst by giving this command:
  286.  
  287.       % /etc/nvram netaddr
  288.  
  289.       From the Command Monitor, you can check IP address in the NVRAM 
  290.       with this command:
  291.  
  292.       >> printenv netaddr
  293.  
  294.       If the four part number returned from either command doesn't match 
  295.       the IP address in /etc/hosts on your workstation (the value of 
  296.       <localIPaddress> that you noted while bringing up inst), change 
  297.       it with one of these two commands (not all models of workstations 
  298.       support changing NVRAM from IRIX):
  299.  
  300.       # /etc/nvram netaddr <localIPaddress>
  301.  
  302.       >> setenv netaddr <localIPaddress>
  303.  
  304.     4) Verify that the remote workstation allows tftpd(1M) access.
  305.       
  306.        See above section on "Enabling TFTP Access on Remote Workstations",
  307.        describes the procedure for verifying that the remote workstation 
  308.        has been modified to allow tftp access. 
  309.  
  310.       To get more debugging information, add the ¡l option to the tftp 
  311.       line in /usr/etc/inetd.conf and restart inetd(1M). The line should 
  312.       look like this:
  313.  
  314.       tftp    dgram   udp     wait    guest   /usr/etc/tftpd  tftpd   -l
  315.  
  316.       Debugging information is written to /usr/adm/SYSLOG.
  317.  
  318.     5) Verify that routers between your workstation and the remote 
  319.        workstation forward bootp(1M) packets.
  320.  
  321.        See above section on "Enabling BOOTP Forwarding on Routers",
  322.        describes the procedure for verifying that routers have been 
  323.        modified to allow bootp access.
  324.  
  325.       To get more debugging informatio, add the -d option on the bootp 
  326.       line in /usr/etc/initd.conf and restart initd(1M).  The line should 
  327.       look like this:
  328.  
  329.       bootp   dgram   udp     wait    root    /usr/etc/bootp    bootp -f -d
  330.  
  331.       Debugging information is written to /usr/adm/SYSLOG.
  332.  
  333.       For more information on networking, see the IRIX Advanced Site and 
  334.       Server Administration Guide and the NFS and NIS Administration Guide 
  335.       and Man Pages.
  336.  
  337.  
  338. 8.2.5  Checking CD-ROM Drives
  339.  
  340.     To check CD-ROM drives, you must verify that:
  341.  
  342.     o  The system recognizes the CD-ROM drive.
  343.  
  344.     o  The CD you want to use is mounted.
  345.  
  346.     The sections below explain the procedures.
  347.  
  348.     Verifying That a CD-ROM Drive is Recognized
  349.  
  350.     The procedure to verify that a CD-ROM drive is recognized depends 
  351.     on your situation:
  352.  
  353.     o If IRIX is running, give the hinv command:
  354.  
  355.       % hinv 
  356.  
  357.       For each CD-ROM drive, you should see one line of output. For 
  358.       example:
  359.  
  360.       CDROM: unit 4 on SCSI controller 0
  361.  
  362.       If you do not see a line of output for a CD-ROM drive, it is not 
  363.       recognized.
  364.  
  365.     o If you are in the miniroot, escape to a shell with the shroot 
  366.       command (see Section 7.20), and give the hinv command:
  367.  
  368.       # hinv 
  369.  
  370.       For each CD-ROM drive, you should see one line of output. For 
  371.       example:
  372.  
  373.       CDROM: unit 4 on SCSI controller 0
  374.  
  375.       If you do not see a line of output for a CD-ROM drive, it is not 
  376.       recognized.
  377.  
  378.     o If you are in the Command Monitor, give the hinv command:
  379.  
  380.       >> hinv 
  381.  
  382.       For each CD-ROM drive, you should see one line of output. Some 
  383.       examples are:
  384.  
  385.       SCSI CDROM: dksc(0,4)
  386.       SCSI CDROM: scsi(0)cdrom(4)
  387.       SCSI Disk: dksc(0,4)
  388.  
  389.       The last example shows the CD-ROM drive on an older workstation. 
  390.       The CD-ROM drive is recognized, but it is shown as a disk. If you  
  391.       do not see a line of output for a CD-ROM drive, it is not recognized.
  392.  
  393.     When a CD-ROM drive is not recognized, it usually because the CD-ROM 
  394.     drive was not powered up properly. If it is an external drive, the 
  395.     CD-ROM drive must be powered on before the workstation main unit is 
  396.     powered on.
  397.  
  398.     The procedure for making the system recognize the CD-ROM drive depends 
  399.     on whether you are running IRIX or the miniroot:
  400.  
  401.     o  If you are running IRIX, exit inst if it is running, warn other 
  402.        users, shut the workstation down with shutdown(1M) or use System 
  403.        Shutdown on the System menu, then reboot the workstation to bring 
  404.        up IRIX again.
  405.  
  406.     o  If you are in the miniroot, get back to the PROM Monitor, press the 
  407.        Reset button on the workstation main unit, and then bring up inst 
  408.        again. If this doesn't fix the problem, turn the CD-ROM drive off 
  409.        and then on again.
  410.  
  411.  
  412.     Verifying That a CD is Mounted
  413.  
  414.     When using a CD-ROM drive, the CD that contains the software you want 
  415.     to install must be mounted. Mounting is done automatically by inst when 
  416.     using a local CD-ROM. When using a remote CD-ROM, the mounting is 
  417.     done by the command cdinstmgr(1).  To verify that the CD is mounted, 
  418.     use the df(1) command below. If you are using local CD-ROM, escape to 
  419.     a shell. If you are using a remote CD-ROM, give the command on the 
  420.     remote workstation.
  421.  
  422.     % /bin/df
  423.  
  424.     Look at the directory names on the right. For local CD-ROM, you should 
  425.     see /CDROM. For remote CD-ROM, the name /CDROM is likely, but another 
  426.     directory name for the mount point, <CDdir>, may have been chosen.
  427.  
  428.     If the CD is mounted, list the files it contains using in order to 
  429.     verify that you have the correct CD inserted. If the CD is not mounted 
  430.     and you are using a remote workstation, verify that cdinstmgr is 
  431.     running. If it isn't, start it.
  432.  
  433.     To verify that a distribution directory or a mounted CD contains 
  434.     the right files, the workstation that contains the distribution must 
  435.     be running IRIX. Change directories to the directory (<distdir> or 
  436.     <CDdir>/dist) and list the files with ls(1). Files in software 
  437.     distributions have these names:
  438.  
  439.     mr
  440.     sa
  441.     <product>
  442.     <product>.idb
  443.     <product>.<image>
  444.     ...
  445.  
  446.